home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 028a / pkzf110.zip / PKZFIND.DOC next >
Text File  |  1991-02-08  |  10KB  |  298 lines
  1.  
  2.  
  3. What's new in PKZFIND 1.1
  4. -------------------------
  5.  
  6. o  Improved speed!  PKZFIND 1.1 is up to 30% faster than
  7.    version 1.0.
  8.  
  9. o  Exit codes supported.  PKZFIND 1.1 sets the DOS Errorlevel
  10.    variable so that the results of a file search can be tested
  11.    for in a batch file.
  12.  
  13. o  New -j 'Jump' option to automatically jump to the drive &
  14.    directory of the first file or directory found.
  15.  
  16. o  PKZFIND 1.0 had a anomaly where if several corrupt .ZIP files
  17.    were encountered by PKZFIND, it would be unable to find files
  18.    within a .ZIP file after that point.  This has been corrected
  19.    in PKZFIND version 1.1.
  20.  
  21. PKZFIND (tm)    File Finder Plus    Version 1.1    10-20-89    Page 1
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                         Table of Contents
  28.                         -----------------
  29.  
  30.  
  31.  
  32.  Topic                                                 Page
  33.  -----                                                 ----
  34.  
  35.     Features ........................................... 2
  36.  
  37.     Using PKZFIND ...................................... 2
  38.  
  39.     Explanation of options ............................. 4
  40.  
  41.     PKZFIND Messages ................................... 5
  42.  
  43.     General Information ................................ 6
  44.  
  45.     Software License ................................... 7
  46.  
  47. PKZFIND (tm)    File Finder Plus    Version 1.1    10-20-89    Page 2
  48.  
  49.  
  50.  
  51. Features of PKZFIND
  52. ------------------
  53.  
  54.   o PKZFIND File Finder Plus works like some other "whereis" type
  55.     programs, except with an important Plus.  The Plus is that PKZFIND
  56.     will not only search all the directories on your diskette or hard
  57.     disk like other "whereis" programs, but PKZFIND will search
  58.     through ZIP files too.  Once PKZFIND finds the desired file,
  59.     PKZFIND can automatically change to the subdirectory where the
  60.     file was found!  PKZFIND will allow you to find any file, Zipped
  61.     or not, simply and easily.
  62.  
  63.   o PKZFIND will run on any MS-DOS machine running MS-DOS version 2.0
  64.     or above, and requires only 32K of free memory to run.
  65.  
  66.   o PKZFIND opens files in SHARE mode, allowing for compatibility
  67.     with network software and LANs.
  68.  
  69.   o PKZFIND is not copy protected.
  70.  
  71.  
  72.  
  73. Using PKZFIND
  74. ------------
  75.  
  76. Recursively searches subdirectories + ZIP files for specified files.
  77.  
  78. Usage: PKZFIND [options] [d:path\] file [file...]
  79.  
  80. Options are:
  81.  
  82.   -b             = Brief listing.
  83.   -c             = Continuous listing, no query after each file.
  84.   -d             = List directory names too.
  85.   -j             = Jump to drive & directory where the first file is found.
  86.   -n             = Do not search ZIP files.
  87.   -z             = Search only ZIP files.
  88.  
  89.   d:path\        = Drive and/or path to start search.  The default
  90.                    is the root directory of the current drive.  If
  91.                    just a drive letter is given, the search will
  92.                    start at the root directory of that drive.  A
  93.                    period "." can be used to denote the current
  94.                    directory.
  95.  
  96.   file [file...] = List of one or more files to search for.  The
  97.                    wildcards * and ? can be used as part of the
  98.                    filename(s).  If no extension is specified, then
  99.                    ".*" will be assumed.
  100.  
  101. PKZFIND (tm)    File Finder Plus    Version 1.1    10-20-89    Page 3
  102.  
  103.  
  104.  
  105. The parameters to PKZFIND can be supplied in any order, and are not
  106. case sensitive.  The options can be preceded by either the "-" or
  107. "/" (DOS switch char) characters.  Multiple options can be specified
  108. together or seperately, in any order.  For example, all the
  109. following syntax are equivalent:
  110.  
  111. pkzfind /dc d: startrek
  112. pkzfind d: -c startrek -d
  113. pkzfind startrek /cd d:
  114.  
  115.  
  116.  
  117. Sample output
  118. -------------
  119.  
  120. Command entered: pkzfind startrek /c
  121.  
  122. PKZFIND   File Finder Plus   Version 1.1   10-20-89
  123. Copyright (c) 1987 PKWARE, Inc. All Rights Reserved.  PKZFIND/h for help
  124.  
  125. /GAMES/STARTREK.ZIP                 43392  01-02-87  00:45:48
  126.    * STARTREK.EXE                   60544  01-22-85  22:57:40
  127. /PIC/PICTURES.ZIP:
  128.    * STARTREK.PIC                  114304  01.12-86  18:08:16
  129. /SIG/SIG0017.ZIP:
  130.    * STARTREK.BAS                   14208  11-02-82  17:07:34
  131.    * STARTREK.DUM                    6144  03-22-82  00:00:00
  132.  
  133. 5 files found.
  134.  
  135.  
  136. The files STARTREK.ZIP, STARTREK.EXE, STARTREK.PIC, STARTREK.BAS
  137. and STARTREK.DUM were found.  The last four files are indented
  138. and preceded by a * indicating that they were found in an ZIP
  139. file.  The name of the ZIP file is listed directly before the
  140. file.  For example, the file STARTREK.EXE is in the ZIP file
  141. STARTREK.ZIP.  Both the files STARTREK.BAS and STARTREK.DUM are in
  142. the ZIP file SIG0017.ZIP.
  143.  
  144. PKZFIND (tm)    File Finder Plus    Version 1.1    10-20-89    Page 4
  145.  
  146.  
  147.  
  148. Explanation of options
  149. ----------------------
  150.  
  151. -b      When PKZFIND finds a file it will display the file's name,
  152.         size, date, and time.  If the -b (brief) option is used
  153.         only the file's name will be displayed.
  154.  
  155. -c      After finding a matching file, PKZFIND will display a
  156.         "More (ynj)?" prompt.  Using the -c (continous listing)
  157.         option will suppress the "More (ynj)?" prompt and cause
  158.         PKZFIND to list all matching files found without stopping.
  159.         PKZFIND can be aborted at any time by pressing Ctrl C or
  160.         Ctrl Break.  If DOS I/O redirection is used, this option
  161.         will default on.
  162.  
  163.         Entering "y" in response to the "More (ynj)?" prompt will
  164.         cause PKZFIND to search for the next matching file.
  165.         Entering "n" will end PKZFIND.  Entering "j" will cause
  166.         PKZFIND to Jump to the drive and subdirectory where the file
  167.         was found.
  168.  
  169. -d      Usually, PKZFIND only searches for files.  Using the -d
  170.         (directory) option will cause PKZFIND to also display
  171.         any matching directory names as well.
  172.  
  173. -j      Jump to the drive and directory where the first matching
  174.         file or directory is found.  This is equivalent to using
  175.     the software without the -c option, and then entering "j"
  176.     as described above.
  177.  
  178. -n      The -n (no ZIP files) option is the opposite of the -z
  179.         option.  Only normal files will be searched for.  Files
  180.         within a ZIP file will not be found.  If you know that
  181.         the desired file is not in a ZIP file, using this option
  182.         can yield better searching performance.
  183.  
  184. -z      The -z (ZIP only) option will force PKZFIND to only
  185.         search ZIP files for the specified file.  Files that
  186.         are not in an ZIP file will not be found.  If you know
  187.         that the desired file is in a ZIP file, using this option
  188.         can yield better searching performance.
  189.  
  190. PKZFIND (tm)    File Finder Plus    Version 1.1    10-20-89    Page 5
  191.  
  192.  
  193.  
  194. PKZFIND messages
  195. ---------------
  196.  
  197. Error in ZIP: ZIP filename
  198.  
  199.   There is an error in the displayed ZIP file.  Searching of
  200.   the ZIP can not proceed.  PKZFIND will skip over this file.
  201.  
  202. PKZFIND: Can't mix Z and D options
  203. PKZFIND: Can't mix Z and N options
  204.  
  205.   The -z (ZIP only) option can not be mixed with either
  206.   the -d (directory) or -n (no ZIP) options.
  207.  
  208.  
  209. Exit Codes
  210. ----------
  211.  
  212. PKZFIND will exit with the following exit codes:
  213.  
  214. 0       At least one or more matching files or directories were found.
  215.  
  216. 1       No matching files of directories were found.
  217.  
  218. 2       Bad or illegal parameters were specified to PKZFIND.
  219.  
  220. PKZFIND (tm)    File Finder Plus    Version 1.1    10-20-89    Page 6
  221.  
  222.  
  223.  
  224. General Information
  225. -------------------
  226.  
  227. PKZFIND will run on any MS-DOS compatible machine running MS-DOS 2.0 
  228. or higher and requires only 32K free RAM.
  229.  
  230. MS-DOS is a registered trademark of Microsoft Corp.
  231.  
  232.  
  233. If you have any questions or comments about PKZFIND send them to
  234. Phil Katz at:
  235.  
  236.  
  237. PKWARE BBS
  238. Glendale, Wisconsin
  239. 414-352-7176
  240.  
  241. or
  242.  
  243. Exec-PC BBS, Bob Mahoney SYSOP
  244. Shorewood, Wisconsin
  245. 414-964-5160
  246.  
  247. or
  248.  
  249. The Sound of Music BBS, Paul Waldinger SYSOP
  250. Oceanside, New York
  251. 516-536-5630
  252.  
  253. or
  254.  
  255. RBBS of Chicago, Loren Jones SYSOP
  256. Chicago, Illinois
  257. 312-352-1035
  258.  
  259. PKZFIND (tm)    File Finder Plus    Version 1.1    10-20-89    Page 7
  260.  
  261.  
  262.  
  263. License
  264. -------
  265.  
  266. Copyright 1989 PKWARE, Inc.  All Rights Reserved.
  267.  
  268. You are free to use, copy and distribute PKZFIND for noncommercial use IF:
  269.  
  270.         NO FEE IS CHARGED FOR USE, COPYING OR DISTRIBUTION.
  271.  
  272.         IT IS NOT MODIFIED IN ANY WAY.
  273.  
  274.  
  275. Clubs and user groups may charge a nominal fee (not to exceed $10)
  276. for expenses and handling while distributing PKZFIND.
  277.  
  278. Site licenses, commercial licenses and custom versions of PKZFIND
  279. are available.  Write to the address below for more information.
  280.  
  281. PKWARE hereby disclaims all warranties relating to this software, whether
  282. express or implied, including without limitation any implied warranties of
  283. merchantability or fitness for a particular purpose. PKWARE will not be liable
  284. for any special, incidental, consequential, indirect or similar damages due to
  285. loss of data or any other reason, even if PKWARE or an agent of PKWARE has
  286. been advised of the possibility of such damages.  In no event shall PKWARE's
  287. liability for any damages ever exceed the price paid for the license to use
  288. software, regardless of the form of the claim.  The person using the software
  289. bears all risk as to the quality and performance of the software.
  290.  
  291. If you find PKZFIND useful and convenient, a registration of $25 would be
  292. appreciated.  Send registrations to:
  293.  
  294. PKWARE, Inc.
  295. 7545 N. Port Washington Rd.
  296. Glendale, WI 53217
  297.  
  298.